Use Application/Browser

UiPath.UIAutomationNext.Activities.NApplicationCard

Description

Ouvre une application de bureau ou une page de navigateur Web à utiliser dans UI Automation.

Après avoir fait glisser et déposé l’activité dans le workflow et indiqué l’application ou la page Web à utiliser, ajoutez les activités à effectuer dans l’activité Use Application/Browser . Si l'application n'est pas déjà ouverte, elle s'ouvre lorsque le projet est exécuté.

Cette activité est compatible avec le référentiel d’objets.

Pour apprendre à utiliser cette activité, voir Tutoriel : travailler avec l'UI Automation.

Remarque :

• À partir de UI Automation v20.10.x, plusieurs activités Use Application/Browser peuvent être imbriquées les unes dans les autres. Cela vous permet d'automatiser plusieurs applications simultanément.
• À partir de la version v21.10.3d'UI Automation , l'activité Utiliser l'application/le navigateur (Use Application/Browser) peut ouvrir des applications dans des environnements distants.
• À partir de UI Automation v22.10.1, l'activité peut également ouvrir des navigateurs dans des environnements distants.

Compatibilité du projet

Windows - Héritage | Windows | Multiplateforme

Windows - Héritage, configuration Windows

Module Designer

• Cliquez sur Indiquer l'application (Indicate Application) pour identifier l'application en déplaçant la souris vers sa fenêtre et en cliquant dessus. Si la cible est une page Web de navigateur, accédez à la page avant d'indiquer l'application.
• Après avoir indiqué la cible, gérez-la en cliquant sur Menu et en sélectionnant les options suivantes :
  • Indiquer la cible à l'écran : indiquez à nouveau l'application.
  • Mettre en surbrillance la cible : affichez l'application indiquée sur votre écran, entourée d'un cadre.
  • Afficher la capture d'écran informative : affichez une capture d'écran de l'application ou de la page Web cible.
  • Supprimer la capture d'écran d'information (Remove informative screenshot ) - Supprime la capture d'écran de l'application cible ou de la page Web.
  • Moteur OCR (OCR Engine) : sélectionnez l'une des deux options suivantes :
    • Moteur OCR intégré (Embedded OCR Engine) : utilisez le moteur OCR intégré dans le modèle Computer Vision AI, à savoir UiPath Screen OCR.
    • Moteur OCR personnalisé (Custom OCR Engine) : utilisez un moteur OCR personnalisé. Lorsque cette option est sélectionnée, un panneau est ajouté à la carte d'activité, où vous pouvez déposer une activité de moteur OCR autre que UiPath Screen OCR.
  • Ajouter au référentiel d’objets (Add to Object Repository ) : ajoutez l’élément d’IU actuel à un projet de bibliothèque, à partir duquel il pourra être réutilisé tout au long de votre processus d’automatisation.

• Vous pouvez lancer une nouvelle instance de l'application ou une nouvelle session de navigateur, en conservant les paramètres de configuration actuels, en utilisant le bouton à côté du Chemin d'accès à l'application (Application Path) (dans le cas d'une application) ou l'URL du navigateur (Browser URL) (dans le cas d'un navigateur). Si vous ouvrez un navigateur via ce bouton, toutes les configurations effectuées dans la section de propriété Options - Navigateur (Options - Browser) sont appliquées, permettant ainsi de tester le comportement de l'activité durant la phase de conception, en atténuant les éventuels échecs au moment de l'exécution.

• Configurez les paramètres de lancement de l'application :
  • Si l'application est un navigateur Web, vous pouvez cliquer sur Plus à droite du champ URL du navigateur (Browser URL), puis utiliser l'une des options du menu pour modifier l'URL de la page Web à ouvrir.
  • Si l'application n'est pas un navigateur Web, vous pouvez :
    • Spécifier les paramètres à transmettre à l'application cible au démarrage à partir du champ Arguments de l' application (Application arguments ). Par exemple, si l'application cible est Acrobat Reader, vous pouvez ouvrir un fichier PDF spécifique en fournissant le chemin complet au fichier. Pour ouvrir le fichier C:\Sample.pdf, cliquez sur Plus > Texte ( Text), puis saisissez C:\Sample.pdf dans le Générateur de texte. Certains types d'applications sont automatiquement identifiés et remplissent automatiquement la propriété Arguments, comme les applications Java, les applications Office Suite, Adobe Acrobat ou l'Explorateur de fichiers Windows.
    • Cliquez sur Plus à droite du champ Chemin d'accès à l'application ( Application path ), puis utilisez l'une des options du menu pour modifier le chemin complet du fichier exécutable à ouvrir. Pour les applications installées en mode utilisateur, l'automatisation n'enregistre pas le chemin réel qui inclut le nom d'utilisateur ; un chemin relatif est utilisé et affiché dans le champ en tant que User Folder.
      Remarque : lorsque le chemin d'accès défini dans le champ Chemin de l'application ( Application path ) est dynamique, le fait de cliquer sur Indiquer la cible à l'écran (Indicate target on screen) dans les activités enfants génère une erreur si l'application cible n'est pas déjà ouverte.
    • Cochez ou décochez la case Correspondance exacte avec le titre (Match exact title). Cette option s'affiche uniquement lorsque vous indiquez la fenêtre entière d'une application et pas seulement un élément dans l'application. En outre, elle ne s'affiche pas lorsque vous indiquez un navigateur Web. Lorsque cette option est cochée, seules les applications qui correspondent exactement au titre de l'application actuelle sont utilisées dans l'automatisation. Lorsqu'elle n'est pas cochée (par défaut), la fenêtre avec le titre qui correspond le mieux est utilisée dans l'automatisation.

Panneau propriétés

Commun

• Continuer en cas d'erreur (Continue on error ) : spécifie si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur. Un nom d'affichage est automatiquement généré lorsque vous indiquez une cible.

  Important :

  Le nom complet de l’activité Utiliser l’application/le navigateur (Use Application/Browser) est également utilisé comme référence qui pointe vers l’application ou le navigateur ciblé. Après avoir indiqué la cible, à moins qu'il ne soit défini manuellement, le nom d'affichage est automatiquement remplacé par le format suivant :

  • Applications : Use Application: [title] - [app name]
  • Pour les navigateurs : Use Browser [browser type] : [title]

  Dans le cas des cartes d'application imbriquées, chaque activité à l'intérieur d'une carte affiche un menu déroulant dans son corps qui vous permet de choisir la carte d'application avec laquelle vous souhaitez l'utiliser.

• Délai d'attente : spécifiez la durée (en secondes) d'attente de l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes.

  Remarque : lorsque vous indiquez une fenêtre dans un environnement Bureau à distance, le paramètre de délai d'expiration par défaut est défini sur 60 secondes.

Entrée

• Application cible unifiée : développez cette catégorie pour configurer les paramètres suivants :

  • Arguments : si l'application n'est pas un navigateur Web, vous pouvez spécifier les paramètres à transmettre à l'application cible au démarrage. Vous pouvez utiliser cette propriété pour ouvrir un fichier spécifique avec l'application. Par exemple, si l'application cible est Acrobat Reader, vous pouvez ouvrir un classeur spécifique en fournissant le chemin d'accès complet au fichier. Pour ouvrir le fichier C:\Sample.pdf, entrez "C:\Sample.pdf". Certains types d'applications sont automatiquement identifiés et remplissent automatiquement la propriété Arguments, comme les applications Java, les applications de la suite Office, Adobe Acrobat ou l'explorateur de fichiers Windows.

  • Chemin d'accès au fichier (File path ) : si l'application n'est pas un navigateur Web, spécifie le chemin complet du fichier exécutable à ouvrir. Si un chemin de fichier est spécifié, la propriété URL est effacée.

    Remarque : lorsque le chemin d'accès défini dans le champ Chemin d'accès au fichier ( File path) est dynamique, le fait de cliquer sur Indiquer la cible à l'écran (Indicate target on screen) dans les activités enfants génère une erreur si l'application cible n'est pas déjà ouverte.
• Sélecteur - Fragment XML qui stocke les attributs d'un élément d'interface utilisateur.
• URL : si l'application est un navigateur Web, spécifie l'URL de la page Web à ouvrir. Si une URL est spécifiée, la propriété Chemin d'accès au fichier est effacée.

Élément d’entrée/de sortie

• Élément d'entrée : l'élément cible que vous souhaitez utiliser avec cette application, stocké dans un objet UIElement . Cet objet peut être récupéré à partir de la propriété Élément de sortie ( Output Element ) d'une autre activité UI Automation. Vous pouvez utiliser ce champ de propriété pour transmettre l'élément cible d'une activité précédente à celle-ci sans avoir à l'indiquer à nouveau. Ce champ ne prend en charge que les variables UIElement .
• Élément de sortie (Output Element ) - Génère l'élément cible indiqué dans cette activité dans une variable UIElement qui peut ensuite être réutilisée dans d'autres activités. Ce champ ne prend en charge que UIElement variables.

Divers

• Privé (Private) : si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose). Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False.

Options

• Fermer (Close) : sélectionnez quand fermer l'application cible une fois que l'automatisation a exécuté toutes les activités ajoutées à l'intérieur de cette activité :
  • Jamais (Jamais) : ne ferme jamais l'application.
  • IfOpenedByAppBrowser : se ferme uniquement si l'application a été ouverte par l'automatisation. Il s'agit de la valeur par défaut.
  • Toujours : ferme l'application à chaque fois.

• Mode d'entrée (Input mode ) : sélectionnez la méthode que le Robot doit utiliser pour interagir avec l'application cible :

  • Événements matériels (Hardware Events ) : utilise le pilote matériel pour effectuer l'action. C'est la méthode la plus lente, elle ne peut pas fonctionner en arrière-plan, mais elle est compatible avec toutes les applications de bureau.

  • Simuler : simule à l'aide des API d'accessibilité. Recommandé pour les navigateurs, les applications basées sur Java, SAP. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.

  • ChromiumAPI - Effectue des actions grâce aux API de débogage. Fonctionne uniquement avec les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l'application cible nest pas au point. Pour plus de détails, consultez cette page.

  • Messages de fenêtre : simulez l'utilisation de messages Win32. Recommandé pour les applications de bureau. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.

  • Arrière-plan (Background) : exécute des actions en arrière-plan. Essaie d'utiliser « Simuler » (Simulate) ou l'API Chromium dans la mesure du possible, tandis que les activités complexes (image, texte natif) s'exécuteront comme d'habitude au premier plan. Il est fortement recommandé d'utiliser cette méthode avec la fonctionnalité Vérifier l'exécution (Verify execution).

    Remarque : l'utilisation du mode de saisie en arrière -plan n'est pas prise en charge avec les applications de la plate-forme Windows universelle, ce qui signifie que les applications de ce type ne peuvent pas être automatisées en arrière-plan.
• Ouvrir (Open) : sélectionnez quand ouvrir l’application cible pour l’exécution de l’automatisation :
  • Jamais : n'ouvre jamais l'application.
  • Si non ouvert (IfNotOpen) - s'ouvre uniquement si l'application est fermée. Il s'agit de la valeur par défaut. Fonctionne uniquement si les champs Chemin d'accès au fichier ( File Path) ou URL (URL) sont renseignés.
  • Toujours : ouvre une autre instance de l'application, même si elle est déjà ouverte. Fonctionne uniquement si les champs Chemin d'accès au fichier ( File Path) ou URL (URL) sont renseignés.

• Redimensionner la fenêtre (Resize window ) - Définit si l'application/le navigateur est redimensionné lors de l'initialisation.

  • Aucun – Aucun redimensionnement n’est appliqué à l’application/au navigateur.
  • Agrandir – L’application/le navigateur est agrandi(e) lors de son lancement.
  • Restaurer à la taille actuelle (Restore to current size ) : l'application/le navigateur est redimensionné(e) et déplacé à la position et à la taille qu'il avait au moment indiqué, si possible.
  • Réduire – L’application/le navigateur est réduit(e) lors de son lancement.
• Window attach mode (Mode d'attachement de fenêtre) - Définit où les activités internes recherchent leurs éléments cibles.
  • Instance d'application : les activités internes effectueront une recherche dans l’instance d’application indiquée, y compris dans toutes les fenêtres parents et enfants (alertes, fenêtres contextuelles, etc.). Les autres instances de l’application sont exclues.
  • Fenêtre unique (Single window ) : les activités internes ne recherchent que dans la fenêtre indiquée.

Options - Navigateur

• Fenêtre incognito/privée : si cette option est sélectionnée, ouvre la nouvelle session de navigateur en mode incognito/privé. Par défaut, cette case est décochée.

• Mode de dossier des données utilisateur : le Mode de dossier des données utilisateur que vous souhaitez utiliser. Cette option est utilisée pour démarrer le navigateur avec un dossier de données utilisateur spécifique.

  • Automatique : déclenche automatiquement le mode Incrustation d’image (PiP) avec un dossier de données utilisateur distinct de celui par défaut. Si le Chemin du dossier de données utilisateur n’est pas défini, un dossier est automatiquement généré. Cela peut être utile lorsque vous recherchez l’isolation du navigateur pendant les tâches d’automatisation et que vous séparez les données de la session de navigation principale.
  • DefaultFolder : utilise le dossier du navigateur par défaut, peu importe qu’il soit exécuté dans la session principale ou dans la session PIP. Cette option est utile si vous souhaitez que le robot utilise le dossier de données utilisateur existant et que vous n’avez pas besoin d’une session séparée ou isolée pour les tâches d’automatisation.
  • CustomFolder : utilise le dossier spécifié dans Chemin du dossier de données utilisateur. Si le chemin du dossier de données utilisateur n’est pas défini, un chemin généré automatiquement est utilisé. Cette option vous donne plus de flexibilité et de contrôle pour gérer vos dossiers pour différentes tâches d’automatisation en définissant un chemin personnalisé pour le dossier de données utilisateur.

  La configuration du dossier de données utilisateur du navigateur n’est disponible que pour Chrome, Edge Chromium et Firefox.

• Chemin du dossier des données utilisateur : le dossier de données utilisateur utilisé par le navigateur. La valeur par défaut est %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType si elle n'est pas définie.

  Vous trouverez plus d'informations sur le Mode de dossier de données utilisateur (User Data Folder Mode ) et le Chemin d'accès au dossier de données utilisateur (User Data Folder Path) .

• WebDriver mode : indique comment WebDriver doit être utilisé lors de l'ouverture d'une nouvelle session de navigateur. Les options suivantes sont disponibles :

  • Désactivé (Disabled ) : désactive l'utilisation de WebDriver.
  • AvecGUI : l'interface graphique du navigateur s'affiche.
  • Sans interface graphique : le navigateur est lancé en mode silencieux, sans interface graphique.

  Vous trouverez plus d'informations sur WebDriver ici.

Configuration multiplateforme

Le nom de l'activité dans les projets multiplateformes est Utiliser le navigateur ( Use Browser ) et ne peut être utilisé que pour automatiser les navigateurs Web.

• Étendue du travail (Work in scope ) - Choisissez l'onglet du navigateur générant le rendu de l'application Web à automatiser.
• URL (URL) : URL de l'application Web. La valeur est automatiquement renseignée après le choix de l'onglet.
• Requiert l'authentification ? - authentification multifacteur activée. Pour plus de détails, consultez la page Connexion de navigateur d'UI Automation ( UI Automation Browser Connection) .

Options supplémentaires

Horaires

• Délai d'attente : spécifiez la durée (en secondes) d'attente de l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes.

• Continuer en cas d'erreur (Continue on error ) : spécifie si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

Options

• Ouvrir (Open) : définit s'il faut ouvrir l'application cible avant d'exécuter les activités à l'intérieur.
  • Toujours : ouvre la fenêtre du navigateur à chaque fois.
  • Si non ouvert (If not open) : ouvre une nouvelle fenêtre de navigateur si aucune ne correspond au sélecteur et à l'URL. Il s'agit de la valeur par défaut.
  • Jamais : n'ouvre jamais la fenêtre du navigateur.
• Fermer (Close) : définit s'il faut fermer l'application cible avant d'exécuter les activités à l'intérieur.
  • Toujours : ferme la fenêtre du navigateur à chaque fois.
  • Si ouvert par Utiliser le navigateur (Use Browser ) : se ferme uniquement si la fenêtre du navigateur a été ouverte par l'activité Utiliser le navigateur ( Use Browser ). Il s'agit de la valeur par défaut.
  • Jamais : ne ferme jamais la fenêtre du navigateur.
• Mode de saisie (Input mode ) : la méthode utilisée pour générer la saisie au clavier et à la souris.
  • ChromiumAPI - Effectue des actions grâce aux API Debugger. Fonctionne uniquement avec les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l’application cible n’est pas au point.
  • Simuler : simule les Actions à l'aide des API d'accessibilité. Fonctionne avec les navigateurs. Envoie tout le texte dans une seule Actions. Fonctionne en arrière-plan (même si l'application cible n'est pas au point).
• Fenêtre Incognito/privée : si cette option est sélectionnée, ouvre la nouvelle session du navigateur en mode incognito/privé. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False.

• ModeDossierDonnéesUtilisateur : le ModeDossierDonnéesUtilisateur que vous souhaitez définir. Cette option est utilisée pour démarrer le navigateur avec un dossier de données utilisateur spécifique.

  • Automatique : déclenche automatiquement le mode Incrustation d’image (PiP) avec un dossier de données utilisateur distinct de celui par défaut. Si le Chemin du dossier de données utilisateur n’est pas défini, un dossier est automatiquement généré. Cela peut être utile lorsque vous recherchez l’isolation du navigateur pendant les tâches d’automatisation et que vous séparez les données de la session de navigation principale.
  • Dossier par défaut : utilise le dossier du navigateur par défaut, peu importe qu’il soit exécuté dans la session principale ou dans la session PIP. Cette option est utile si vous souhaitez que le robot utilise le dossier de données utilisateur existant et que vous n’avez pas besoin d’une session séparée ou isolée pour les tâches d’automatisation.
  • Dossier personnalisé : utilise le dossier spécifié dans Chemin du dossier de données utilisateur. Si le chemin du dossier de données utilisateur n’est pas défini, un chemin généré automatiquement est utilisé. Cette option vous donne plus de flexibilité et de contrôle pour gérer vos dossiers pour différentes tâches d’automatisation en définissant un chemin personnalisé pour le dossier de données utilisateur.

  La configuration du dossier de données utilisateur du navigateur n’est disponible que pour Chrome, Edge Chromium et Firefox.

• Chemin du dossier des données utilisateur : le dossier de données utilisateur utilisé par le navigateur. La valeur par défaut est %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType si elle n'est pas définie.

Cible

• Sélecteur (Selector ) - Liste des attributs utilisés pour rechercher une fenêtre de navigateur particulière.

Entrée/sortie

• Élément d'entrée (Input element ) : l'élément de l'interface utilisateur sur lequel l'activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.